home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 301-325 / 307 / fileio / readmefirst! < prev    next >
Text File  |  1995-03-14  |  3KB  |  70 lines
  1.    This is the FileIO requester.library, a disk-based shared library that
  2. can be opened and used by many applications. It's primary purpose is to
  3. allow a user of your program to easily make filename selection for load
  4. and save routines using the Amiga Intuition interface. The FileIO requester
  5. has many features:
  6.  
  7.    - The ability to scroll through the list of filenames and drawers using
  8.      the mouse, slider (Prop), and Arrow (boolean) gadgets.
  9.  
  10.    - The option to select a filename by pointing and clicking the mouse,
  11.      or typing in a string gadget.
  12.  
  13.    - The option to change disk (root) and sub directories with the mouse or
  14.      string gadgets.
  15.  
  16.    - Returns information to your program about the size of the selected
  17.      file, the number of free bytes on that file's disk, intelligently
  18.      separates disk and drawer names from filenames, etc.
  19.  
  20.    - Is written in tight 68000 and is approx 10K in size total (i.e. even
  21.      after loading, unlike other requesters)
  22.  
  23.    - Can display a list of devices/disknames by clicking the right mouse for
  24.      easy selection of a particular device/disk.
  25.  
  26.    - Can display lists of custom strings (i.e. non-filename operation)
  27.  
  28.    This version of the FileIO library is an update to the one that appeared
  29. on Fish Disk #257. This is version 1.5. A new feature allows the user to
  30. select multiple filenames. The new doc file describes this feature fully, and
  31. there are new examples in C and asm to show how to utilize this feature.
  32.    Also, this version fixes the following bugs in 1.4
  33.  
  34.    1). The original documentation had the parameters sent to a custom handler
  35.        written in C in the wrong order. The new document details the correct
  36.        arg order.
  37.  
  38.    2). The bug in the FILEIO's FileSize field is fixed. Previously, when
  39.        using device names, it was set to a size of 7 bytes. Ick!! Also, it
  40.        is now set properly when the user types in a filename and then selects
  41.        OK without hitting RETURN first.
  42.  
  43.    3). Title bar input is now scrollable so that the user can enter/edit text
  44.        via the window's title bar and actually see everything.
  45.  
  46.    4). PromptUserEntry() now properly stores a $1B (ESC) when the user presses
  47.        escape.
  48.  
  49.    5). A new NO_ALPHABETIZE flag has been added so that filenames aren't put
  50.        in alphabetical order.
  51.  
  52.    6). Selecting CANCEL when in SPECIAL_REQ mode no longer causes subsequent
  53.        invocations of DoFileIO() with that FileIO struct to always return
  54.        a CANCELLED operation.
  55.  
  56.    With this many features, why are you waiting for the stripped-down file
  57. requester that is supposedly forthcoming with 1.4 OS?
  58.    This library can be used by any C, asm, or Basic application.
  59.    The actual requester.library file must be placed in the libs drawer of
  60. your bootdisk in order to run these examples. You can run the CopyLib program
  61. to copy this library to your bootdisk. If the FileIO requester appears, the
  62. library was copied OK. Select the cancel gadget to exit. Alternately, you
  63. may simply copy the file using the CLI.
  64.    Additionally, basic users must copy requester.bmap (and any other bmap
  65. files) to the current dir when using the basic examples. It might be a good
  66. idea to copy the bmap files to the lib drawer of the boot disk along with
  67. the library, then modify the lines in the example programs to include this
  68. path.
  69.         LIBRARY  "sys:libs/requester.bmap"
  70.